Ioctls¶

Trois ioctls sont disponibles pour les sockets AF_INET. Elles prennent un pointeur sur une struct arpreq comme paramètre.

struct arpreq {


    struct sockaddr arp_pa;      /* adresse protocole */


    struct sockaddr arp_ha;      /* adresse matérielle */


    int             arp_flags;   /* attributs */


    struct sockaddr arp_netmask; /* masque réseau du protocole */


    char            arp_dev[16];
};

SIOCSARP, SIOCDARP et SIOCGARP ajoute, supprime, et consulte respectivement une correspondance ARP. L'ajout et la suppression de correspondance ARP sont des opérations privilégiées ne pouvant être réalisées que par un processus avec la capacité CAP_NET_ADMIN ou un UID effectif nul.

arp_pa doit être une socket AF_INET et arp_ha doit être du même type que le périphérique indiqué dans arp_dev. arp_dev est une chaîne terminée par un caractère nul, contenant le nom d'un périphérique.

Si l'attribut ATF_NETMASK est activé, alors le membre arp_netmask doit être valide. Linux 2.2 ne supporte pas les entrées ARP proxy réseau. Ainsi, il doit être configuré avec 0xFFFFFFFF ou 0 pour supprimer une entrée arp proxy existante. ATF_USETRAILERS est obsolète et ne doit pas être utilisé.

Interfaces /proc¶

ARP supporte une série d'interface /proc pour configurer les paramètres sur une base globale ou interface par interface. Les interfaces sont accessibles en lisant ou en écrivant dans les fichiers /proc/sys/net/ipv4/neigh/*/*. Chaque interface dans le système a son propre répertoire dans /proc/sys/net/ipv4/neigh/. La configuration dans le répertoire « default » sert pour tous les nouveaux périphériques. Sauf mention contraire, les durées sont en secondes.

anycast_delay (depuis Linux 2.2)

Le nombre maximum de jiffies à attendre avant de répondre à un message de sollicitation IPv6 du voisinage. Le support Anycast n'est pas encore implémenté. Par défaut, le délai est 1 seconde.

app_solicit (depuis Linux 2.2)

Le nombre maximum d'essai d'envoi au démon ARP de l'espace utilisateur par netlink avant de basculer en tentatives multicast (voir mcast_solicit). La valeur par défaut est 0.

base_reachable_time (depuis Linux 2.2)

Une fois qu'un voisin a été trouvé, l'entrée est considérée comme valide pendant, au moins, une durée aléatoire entre base_reachable_time/2 et 3*base_reachable_time/2. La validité d'une entrée sera étendue si on reçoit un retour positif des protocoles de plus haut niveau. La valeur par défaut est 30 secondes. Ce fichier est maintenant obsolète et remplacé par base_reachable_time_ms.

base_reachable_time_ms (depuis Linux 2.6.12)

Comme pour base_reachable_time, mais le temps est mesuré en millisecondes. La valeur par défaut est 30000 millisecondes.

delay_first_probe_time (depuis Linux 2.2)

Délai avant la première tentative multicast après avoir décidé qu'un voisin est gelé. La valeur par défaut est 5 secondes.

gc_interval (depuis Linux 2.2)

Fréquence avec laquelle on vérifie les entrées valides. La valeur par défaut est 30 secondes.

gc_stale_time (depuis Linux 2.2)

Fréquence avec laquelle on vérifie une entrée de voisinage gelée. Lorsqu'une correspondance est considérée comme gelée, elle sera à nouveau redéterminée avant d'y envoyer des données. La valeur par défaut est 60 secondes.

gc_thresh1 (depuis Linux 2.2)

Le nombre minimal d'entrées à conserver dans le cache ARP. Le récupérateur ne sera pas déclenché s'il y a moins d'entrées que cette valeur. La valeur par défaut est 128.

gc_thresh2 (depuis Linux 2.2)

La limite maximale souple d'entrées à conserver dans le cache ARP. Le récupérateur autorisera un dépassement de cette valeur pendant 5 secondes avant de lancer une véritable récupération. La valeur par défaut est 512 entrées.

gc_thresh3 (depuis Linux 2.2)

La limite maximale d'entrées à conserver dans le cache ARP. Le récupérateur sera immédiatement déclenché si cette valeur est dépassée. La valeur par défaut est 1024.

locktime (depuis Linux 2.2)

Le nombre minimum de jiffies pendant lesquels on conserve une entrée ARP dans le cache. Ceci évite la dégradation du cache s'il y a plusieurs correspondances possibles (généralement à cause d'une mauvaise configuration du réseau). La valeur par défaut est 1 seconde.

mcast_solicit (depuis Linux 2.2)

Le nombre maximal de tentatives de résolution d'une adresse par le multicast et le broadcast avant de marquer l'entrée comme inaccessible. La valeur par défaut est 3.

proxy_delay (depuis Linux 2.2)

Lorsqu'une requête arrive pour une adresse proxy-ARP, on attend proxy_delay jiffies avant de répondre. Ceci permet d'éviter des saturations du réseau dans certains cas. La valeur par défaut est 0,8 secondes.

proxy_qlen (depuis Linux 2.2)

Le nombre maximal de paquets qui peuvent être conservés pour des adresses proxy-ARP. La valeur par défaut est 64.

retrans_time (depuis Linux 2.2)

Le nombre de jiffies à attendre avant de retransmettre une requête. La valeur par défaut est 1 seconde. Ce fichier est maintenant obsolète et remplacé par retrans_time_ms.

retrans_time_ms (depuis Linux 2.6.12)

Le nombre de millisecondes à attendre avant de retransmettre une requête. La valeur par défaut est 1000 millisecondes.

ucast_solicit (depuis Linux 2.2)

Le nombre maximal de tentatives d'envoi unicast avant d'interroger le démon ARP (voir app_solicit). La valeur par défaut est 3.

unres_qlen (depuis Linux 2.2)

Le nombre maximal de paquets conservés pour chaque adresse non résolue par les autres couches réseau. La valeur par défaut est 3.